Manage COS Servers

In the CADMATIC desktop, Object > Manage COS Servers opens the Manage CO Designer dialog where you can manage COS networks and COS servers. This tool has some additional features that the original Object > Manage COS tool does not have, such as being able to set a replica server offline via its master server, and scheduling backups for multiple servers.

Server Tree tab

In the Manage CO Designer dialog, the Server Tree tab displays a hierarchical tree of known COS networks. Each network includes exactly one root COS server, which is usually accompanied by one or more subordinate COS servers. In the context of replication, a server with its own subordinates is referred to as a 'master server', and its direct subordinates are called 'replica servers'.

  • <networkName>

    • <networkName>_Root (<host:port>)
      • <networkName>_<server2Name> (<host:port>)
        • <networkName>_<server3Name> (<host:port>)

If a specific server is not listed, it can be added as described in Add or remove servers.

Selecting a COS network or COS server from the tree will attempt to connect to COS. For a successful connection, the Manage CO Designer tool and the target COS server must be of the same main version.

Server List tab

In the Manage CO Designer dialog, the Server List tab displays a simple list of known COS servers. In this list, each root server is followed by the other servers included in the same COS network.

  • <networkName>_Root
  • <networkName>_<server2Name>
  • <networkName>_<server3Name>

If a specific server is not listed, it can be added as described in Add or remove servers.

Selecting a COS server from the list will attempt to connect to COS. For a successful connection, the Manage CO Designer tool and the target COS server must be of the same main version.

You can right-click a server in the server list to show or hide columns, except Name is always shown.

Column

Description

Name

The name of the COS server.

Host

The name of the host computer.

Port

The TCP/IP port of the COS server.

Network

The name of the COS network. This is also known as the Schema name.

Databases

The names of the library and project databases in the COS server.

KnownVersion

The release version.

LastConnectedTo

The date and time when the server was last connected to.

Add or remove servers

In the Manage CO Designer dialog, in the Add or remove servers section, you can connect and disconnect COS servers. Once a server is connected, it can be managed via the Server Tree tab and Server List tab.

When you establish a connection to a COS server using either a Windows or COS account, the connection information is saved in a local credential manager, influencing your future log-ins. If you wish to change your login method for a particular server, you will need to remove the existing connection and then reconnect using different credentials.

Control

Description

Connect

Opens the Connect to COS server dialog for connecting to a COS server.

  • Address – Enter the address of the COS server using the hostname (or IP address) and port, separated by a colon.

    Example: MyPC:5000

  • Connect using – Select how to connect:

    • With your current Windows account.

    • With another Windows account.

    • With a COS user account.

Important: Establishing a connection with a COS user account is a crucial step for those intending to run design applications specifically with their COS user account, rather than their Windows account.

Remove

Disconnects your environment from the selected COS servers. This is a necessary step if you wish to reconnect to a server with different credentials. Alternatively, you can use this function to hide a server that you do not need to interact with.

Note: If the removed server is the only server in the given COS network, hiding the server will also hide the COS network.

Scan

Scans the selected COS server for any replica servers that are not listed in the management tool. Only a connected server can be scanned.

Network settings

On the Server Tree tab, select a COS network to display the following settings.

Object Types | Attributes | User Profiles | Security Policies

Object Types

On the Network settings pane, select the Object Types tab to manage the attribute assignments and security settings of object types in the selected COS network. The list can be filtered by entering a text string into the Object type filter field.

Object types generally fall into three categories:

  • Object types that manage design data, such as 'Model Object' or 'Drawing'. These provide COS objects that users can access via an object browser instance (like documents) or a custom user interface.
  • Object types that manage reference data, such as 'Catalog Part' or 'Sheet'. Usually, these are stored in the library database, but they can also be created in projects. These objects can be managed through the Desktop application (Object menu > Library and Project Databases).
  • Object types that represent internal structures, such as 'Import History'. These objects have little significance to users as they are never accessed directly and cannot be seen via any object browser interface. However, these object types are displayed in the common configuration, and occasionally, it may be necessary to change their Security settings.

The set of available COS object types is fixed—user organizations cannot create new object types.

You can expand an object type in the list to see its attributes.

You can select an object type to manage it using the following commands.

Control

Description

Assign

Opens the Select attributes to add to object type… dialog for assigning COS attributes defined on the Attributes tab to the selected object type.

Unassign

Unassigns the selected attribute from the object type.

You cannot unassign hard-wired attributes essential to the application.

Order

Opens the Select the sort order for attributes of… dialog for adjusting the order in which the attributes are presented. Select an attribute and click Up or Down to change its SortOrder value; the smaller the value, the higher the attribute is in user interfaces that list the attributes.

Recommended

Opens the Select recommended attributes for… dialog for specifying which attributes are included by default in new objects of this type.

Security

Opens the Object Type Access Rights dialog for selecting which User Profiles are allowed to Create, Modify, and Remove objects of this type.

Certain application functions require that also users can write to certain project objects. Otherwise, there is no great risk in limiting the access rights—you can easily restore the original rights if needed. For example, limiting the access rights of library objects such as GDLs will not affect the functionality of the program, it will only affect the users who can no longer modify those objects.

Note: You cannot restrict access to specific object subtypes, such as model objects that represent air ducts.

Attributes

On the Network settings pane, select the Attributes tab to manage attributes that are stored in COS. The list can be filtered by entering a text string into the Filter field.

Attributes provide a flexible mechanism for attaching additional information to COS objects. This information can be, for example, the name of a component manufacturer or the approval status of a drawing.

There are a number of predefined attributes, and you can also create new ones. Attributes can be assigned to object types on the Object Types tab. An attribute's configuration specifies whether the attribute can be assigned to multiple object types or only to a single object type at a time.

You can manage attributes with the following commands.

Control

Description

New

Opens the Attribute Properties dialog for creating a new COS attribute.

Edit

Opens the Attribute Properties dialog for editing the properties of the selected attribute.

You cannot edit hard-wired attributes essential to the application.

Remove

Deletes the selected attribute, without prompting you to confirm the action.

You cannot delete attributes that are currently assigned to Object Types or hard-wired attributes essential to the application.

Attribute Properties

Starting to create or edit a COS attribute opens the Attribute Properties dialog.

Attributes have common properties and attribute type specific properties.

Property

Description

Name

The name of the attribute. Names can consist of 1-99 characters.

Tag

Abbreviation that identifies the attribute. Abbreviations can consist of 1–3 characters, which can include letters (a-z, A-Z), numerals (0-9), and some special characters.

Type

The type of the attribute:

Unique Assign

Select this option to specify that the attribute can only be assigned to a single COS object type at a time.

This option cannot be selected if the attribute is already assigned to more than one COS object type. Clicking Show Conflicting Types lists those object types.

String

Attributes whose type is 'string' can store a plain-text value of a given length; it is the most versatile attribute type.

Control

Description

Maximum length

The maximum length of the string value. If not defined, the maximum is 80 characters.

Integer

Attributes whose type is 'integer' can store a numeric value without decimals. Optionally, the attribute can limit the range of acceptable values.

Control

Description

Minimum value

The minimum attribute value.

Maximum value

The maximum attribute value.

Time

Attributes whose type is 'time' can store a date/time value. Optionally, the attribute type can specify the earliest possible time.

This attribute type is not supported in all user interfaces.

Control

Description

Minimum value

The minimum attribute value in the format d.m.yyyy hh.mm.ss.

Enumerated

Attributes whose type is 'enumerated' specify all the possible string values that the attribute can be set to.

You can use the following commands to define the list of values.

Control

Description

Add

Adds a new choice value item to the list. To define the value, either select the default value and click Rename, or double-click the default value, type the new value, and press Enter to accept the value.

Remove

Deletes the selected choice value.

Rename

Opens a dialog for editing the selected choice value.

Dependencies

Opens a dialog for selecting which other attributes must be present in the COS object for the choice to be available.

Up, Down

Adjusts the selected choice value's list position. You can arrange the choice values in alphabetical order by clicking the Value column header.

Floating point

Attributes whose type is 'floating point' can store a numeric value with decimals. Optionally, the attribute type can specify the range of acceptable values.

Control

Description

Minimum value

The minimum attribute value.

Maximum value

The maximum attribute value.

Quantity type

The quantity type. See Quantity definitions and their units of measure.

Coded enumerated

Attributes whose type is 'coded enumerated' specify all the possible values that the attribute can be set to, with an additional numeric code (0, 1, 2, …) attached to each value. This attribute type is mainly used for predefined attributes where the numeric code has some specific meaning to the software.

You can use the following commands to define the list of values.

Control

Description

Add

Adds a new choice value item to the list. To define the value, either select the default value and click Rename, or double-click the default value, type the new value, and press Enter to accept the value.

Remove

Deletes the selected choice value.

Rename

Opens a dialog for editing the selected choice value.

Dependencies

Opens a dialog for selecting which other attributes must be present in the COS object for the choice to be available.

Up, Down

Adjusts the selected choice value's list position. You can arrange the choice values in alphabetical order by clicking the Value column header.

User Profiles

On the Network settings pane, select the User Profiles tab to manage user profiles. The user profile to which the User Accounts of CADMATIC users are assigned determine what kind of administrative permissions they have. Permissions are granted to user profiles in the Security Policies settings.

There is always at least one default user profile: when creating a new COS server, the server installer creates the "System Administrator" user profile, and assigns to it the user account of the user who is performing the installation. This default system administrator can then create additional user profiles by making a copy of the default profile.

The CADMATIC example project has three default user profiles:

  • System Administrator

  • Project Administrator

  • User

You can use the following commands to manage the currently selected user profile.

Control

Description

Copy

You can create a new user profile by selecting an existing profile, clicking Copy, and entering a name for the new profile to be created.

Note: User profiles can only be changed at the root server or a subordinate server that maintains an online connection to the root server.

Remove

Deletes the selected user profiles, without prompting you to confirm the action.

You cannot delete the default user profiles.

Export

Opens a dialog for exporting the selected user profiles into a file.

Import

Opens a dialog for importing a user profile file created with the Export command. If a given user profile already exists, the import skips that profile; it does not update or replace an existing user profile.

Schema name

On the Network settings pane, select the User Profiles tab to display the Schema name field. This field shows the current name of the selected COS network. If there is a need to modify this name, enter the new name and click Set.

Security Policies

On the Network settings pane, select the Security Policies tab to manage which User Profiles are allowed to perform specific administrative actions in the selected COS network.

Policy

Details

Modify common database schema: object types and attributes

This policy enables modification of Object Types and Attributes.

Modify common security items: user profiles, policies, type permissions

This policy enables defining User Profiles, Security Policies, and object type specific Security settings.

Administrate servers in user's own domain: create and modify user accounts; create, remove, backup and restore databases

This policy enables defining User Accounts and managing Databases in COS servers that share the same user accounts.

Forcibly cancel checked out status and replica ownership for any object

This policy enables forcible canceling of object check-outs and taking or requesting object ownership from replica servers.

Note: This policy is required for debugging databases with the Debug command.

Upgrade hardwired system schema to new product version

This policy is only needed when the software has been upgraded to a newer version and the project environment needs to be upgraded to be compatible with the new software version. At other times, we recommend this policy to be disabled.

Note: Upgrading of schema cannot be undone, except by restoring the old version from a backup that has been created with the old software version.

Modify databases with access control

This policy enables reading, creating, modifying, and deleting objects in library and project databases that are using access control. The users whose user profile is not assigned to this policy can only read data from the database.

Access control is in use when the Policy control option is enabled in the Database properties.

Note: To edit this security policy, your user profile must be included in the security policy Administrate servers in user's own domain: create and modify user accounts; create, remove, backup and restore databases.

User is allowed to create CX exports and to read them into a project

This policy enables CX export and import.

Server control

On the Server Tree tab or Server List tab, select a COS server to display the following settings.

Statistics | Event Log | Clients | Databases | User Accounts | Backup | Replication

Statistics

In the Server control settings, select the Statistics tab to view information about the selected COS server.

Property

Description

Software Version

Displays the software version and build date of the COS server.

Process ID

Displays the process identifier of the COS server process in the server computer.

Server type

Displays the server type: "Root" or "Replica".

The root server is the highest-level server in a COS network; it does not have a master server but may function as one. All other servers are replica servers: they replicate data upward to their master, eventually reaching the root server. In standalone installations the root server may be the only COS server that is needed, whereas in distributed environments the root server initiates a chain of servers typically located at various sites. The root server functions as a master server to its direct subordinates, and those subordinates function as a master server to their direct subordinates.

Server GUID

Displays the GUID string that identifies the COS server.

Server schema version

Displays the version number of the COS server's hardwired schema.

Server protocol version

Displays the version number of the COS server's protocol.

State Info

Up since

Displays the last startup date and time of the COS server.

Last backup made

Displays the date and time of the last successful backup.

Replication Info

Last online update with master

For an online replica server, displays the date and time when the server last received an update from the master server. Otherwise, displays "N/A". See Replication.

Files waiting to be uploaded

Displays the number of files waiting to be uploaded to the COS server.

Replica tree

The Replica tree pane lists the servers that are part of the same replication tree as the selected server, displaying the following information:

  • Name – Displays "Root" or the name of the subordinate server.

  • Last Heard of – Displays the date and time when the server was last connected to, or "N/A".

  • Read-Only – Displays if the server is read-only. The read-only state can be enabled or disabled via master (Replication > Properties) or replica (ReplicationServer is Read-Only) server.

Event Log

In the Server control settings, select the Event Log tab to review recent events in the selected COS server.

For each event, you can see the date and time when the event occurred, the category of the event (I – information, W – warning, E – error), the user or system session where the event occurred, and the message related to the event. If the same user has several simultaneous sessions, they are numbered sequentially in the User(session) column, starting from zero: <user>(0), <user>(1), <user>(2), and so on.

Control

Description

Find

Enter a search string and click Next or Prev to find its nearest occurrence in the log.

Refresh

Refreshes the list of events from the log file.

Read File

Opens a file browser for opening a different log file from the disk.

You can use filtering to show only relevant log entries: you can filter the log by category, user, message, or time.

Clients

In the Server control settings, select the Clients tab to see which clients have an open session in the selected COS server.

Control

Description

Refresh

Refreshes the client list.

Disconnect

Disconnects the selected client from COS. If a session has not shown any activity for a long time, it is possible that the client application has been closed but the server was not notified. This might occur, for example, when a workstation suddenly loses power. You should remove such sessions with Disconnect, as the sessions might be locking objects.

Databases

In the Server control settings, select the Databases tab to manage the library and project databases of the selected COS server.

Control

Description

Properties

Opens the Database properties of the selected database. Also double-clicking a database opens the properties.

Compress

Compresses the selected database to use disk space more efficiently. The program performs this task automatically, so under normal circumstances, there should be no need to execute this command.

Rebuild

Rebuilds the selected, potentially damaged database. The program performs this task automatically if it detects that the database was not properly closed. Therefore, under normal circumstances, there should be no need to execute this command.

Remove

First prompts you to confirm this action, and then attempts to delete the selected database. However, deletion may not be possible if the database is in use.

Rename

First prompts you to confirm this action, and then opens a dialog for renaming the selected database. However, renaming may not be possible if the database is in use.

Important: Contact Cadmatic Customer Support before using this command.

Debug

Opens the selected databases in the Debug Databases dialog. You can debug a maximum of two databases simultaneously:

  • One library and one project database.

  • Two library databases.

  • Two project databases.

Note: In the CADMATIC desktop, selecting Object > Tools > Run DM Tools and then Debug Databases always opens the library and project database of the current project.

Refresh

Refreshes the database list.

Database properties

In the Server control settings, on the Databases tab, select a database and then Properties to display the properties of that database.

General

In the database properties, the General tab displays general information about the database.

Enabling Policy control makes it possible to control modification permission via the Modify databases with access control control policy.

Types

In the database properties, the Types tab displays the object types defined in the database.

File Storage

In the database properties, the File Storage tab displays how many objects of each object type exist in the database and how much space they consume.

Replication

In the database properties, the Replication tab displays the replication status of the database.

User Accounts

In the Server control settings, select the User Accounts tab to manage the user accounts of the selected COS server. All users of design applications must have a user account in COS. This identification serves several purposes, such as:

  • Protecting access to design data. Only authenticated users can log in and access the data in the COS databases.

  • Protecting the integrity of design data. Only the user who has checked out an object can modify and eventually check in that object. While the object is checked out, other users can see who is currently working with that object.

  • Preventing accidental editing. The execution of certain operations can be limited to a specific group of users.

  • Keeping track of changes. Creating or modifying an object stores the user name and the time of the occurrence.

  • Keeping track of errors and other system events. Events that occur during a user session are stored in the system's log, and user names are part of this information.

User accounts can be authenticated by either Windows or COS.

  • When using Windows authentication, authentication is performed by the domain controller, and the COS server does not need to know the user's password.

  • When using COS authentication, authentication is performed by the COS server, and the user's password must be specified in Manage CO Designer.

Whenever design applications need to be accessed using COS authentication, first the users need to connect to the COS server as described in Add or remove servers, to prevent automatic Windows authentication.

Control

Description

New

Opens the User Properties dialog for adding a new user.

Import

Opens the Add From User Group dialog for importing users from a domain group.

  • Account Type – The user profile to assign to the new users. See User Profiles.

  • Domain Group – The name of the domain group from which to import users.

  • Limit to active users – Select this option to hide those domain group members who have been inactive for longer than what the Activity limit specifies.

  • Users to Add – Select the users to import from the group, and then click OK.

Edit

Opens the User Properties dialog for editing the selected user's properties, for example, if the user's Windows account name has changed, or if the user account needs to be assigned to a different user profile.

If you are editing your own information and you are the only administrator, you cannot select a non-administrative user profile.

If the COS server was installed with HCA support for CADMATIC Hull, there is an automatically generated HCA COS user account that cannot be edited or removed.

Remove

Cancels the checkouts of the selected users and removes the user accounts from the COS server. You are prompted to confirm the action.

Even if a user should be denied access to COS, removing their user account might not be desirable. This is because information about the creator and modifier of an object is stored in the object's properties, and if the user account no longer exists, the user is displayed as "Unknown". Therefore, we recommend creating a special user profile such as "Former Employee", removing all access permissions from this user profile, and assigning user accounts that are no longer active to this user profile. This way user accounts can be deactivated without causing loss of valuable information.

If the COS server was installed with HCA support for CADMATIC Hull, there is an automatically generated HCA COS user account that cannot be edited or removed.

User Properties

Starting to create or edit a user account opens the User Properties dialog.

You can define the following properties for a user.

Property

Description

Identification

Specify how COS is to identify the user.

Account Name

Enter the account name of the new user. For Windows authentication, enter it in the format domain\user.

Two COS accounts cannot use the same Windows account name.

Full Name

Enter the full name of the new user. This is the name that will be visible to other users of the applications.

You can use either the "Firstname Lastname" or "Lastname Firstname" format, as you prefer.

Tip: If using Windows authentication, leaving this field empty will retrieve the full name from the domain controller. This also serves as a confirmation that the account name has been entered correctly.

Authentication

Select whether the user should be authenticated using Windows authentication or COS authentication.

For COS authentication, you must specify and confirm the password for this account.

Access Rights

Specify the access rights of the user account by assigning it into one of the User Profiles.

Profile

Select a user profile for the user.

Backup

In the Server control settings, select the Backup tab to manage the creation of backups for the selected COS server. You can schedule backups to occur automatically or create a single backup immediately.

A COS backup file, which is technically a zip archive, stores the state of a certain COS server at a certain moment. Its purpose is to allow the server to be restored if its contents are lost. Despite being a type of archive, backups should not be confused with COS archives, which are intended for long-term storage of project data.

Backup files have the extension .bup and contain the following information:

  • The database schema and other global configurations.

  • The server's local configuration.

  • All COS databases, including libraries and projects.

  • The project document files.

  • Optionally, the SQL database of P&ID (.bak).

The backup file does not contain any data stored in the users' workspaces, because the COS server does not know their locations. The data in the P&ID SQL database is stored with individual diagram objects.

When using the scheduling function, ensure that backups are being created according to the specified schedule by monitoring the target folder, the COS server's Event Log, or the operating system's Event Log.

Control

Description

Target

Specify where to store the backup files.

Backup path

Specify the path to the folder where the backup files will be created.

The path can point to either a local folder on the server computer or a remote folder located on a different computer. To use a remote folder, define the path as a UNC path.

The backup process creates temporary files on the local disk and removes them when they are no longer needed.

The backup files are named in the format <serverName>_<yyymmdd>.bup.

Important: The project's settings can specify that a COS backup must include an SQL backup, as described in SQL backup. To do this, the SQL server must have access to the target directory. However, it does not support UNC paths. Therefore, a COS backup that includes an SQL backup can only succeed if both COS and SQL are installed on the same computer, and the target directory is a local folder on that computer. If the backup path specifies a remote folder with a UNC path, the operation will fail when attempting to back up the SQL data. If COS backups require a remote folder, SQL backups must be created separately on the local disk, as described in Create SQL Backup.

Account

Specify the user account the backup process will use for writing to the target folder.

The server's user account

Select this option to use the COS server's user account for creating the backups. This is the user account that you used to Connect to the server.

Note: If the backup path points to a remote folder, this must be a domain account that has the required privileges on the target computer.

Another account

Select this option to use a specified user account for backups, for example, when the backup files are saved to a remote computer.

Note: If the backup path points to a remote folder, this must be a domain account that has the required privileges on the target computer.

Scheduled backup

Specify a schedule for automatic backups.

Start backup daily

Select this option to back up the data of the selected COS server every day.

Enter the start time in the format hh:mm.

Delete backups older than

Select this option to automatically delete the daily backup after a specified number of days.

Backup now

You can create a backup immediately.

Backup now

Opens the Create Backup dialog for making a COS backup immediately. This can be useful for backing up data just before a maintenance operation, or backing up a stand-alone installation on a laptop computer that is powered off when not being used. As in scheduled backups, specify the target folder and the user account to use for the operation.

Replication

A globally distributed project can encompass multiple sites, where a 'site' is a geographical location like a design office, construction site, or shipyard that houses a number of CADMATIC users connected to a local area network, sharing resources within that network. However, they cannot readily access resources located at the other sites. Moreover, users who utilize a laptop computer and do not consistently work at the office need to have their own designated site.

The CoDesigner functionality allows for intelligent distribution of design work using replication of COS databases and document files, as well as managing of project data ownership. Each site installs a COS server equipped with CoDesigner. These servers provide database and file replication services for CADMATIC applications.

The sites and their servers interconnect in a star-like or tree-like structure. One specific site centrally manages the project, known as the 'main site'. The main site is the project's first site and is implicitly initiated when the project is created on the root server.

Other sites, such as subsidiary offices and subcontractors, known as 'satellite sites', host replica servers. They connect to either the main site or other satellite sites. Data exchange between sites can occur in two ways: through direct communication or manual file transfer.

In the Server control settings, select the Replication tab to manage the replication settings of the selected COS server.

  • If the COS network lacks replica servers, all settings are disabled.

  • If the selected server is a root server, you can manage its replica servers.

  • If the selected server is a replica server, you can manage its communication with its master server.

Control

Description

Update Settings

These settings specify how the selected replica server exchanges data with its master server.

Server is online

Select this option to enable the replica server to regularly exchange updates with the master server and other servers linked to the master. Clicking Set applies the setting and performs an update.

If not selected, the replica server is to exchange updates with the master server by using manual file transfer.

Non-blocking update mode

Select this option to specify that the replica server is to exchange updates with the master server by using sequential file transfer.

If not selected, the updating occurs simultaneously at both sites in direct mode. This requires a stable online connection.

For more details, see Online replication modes.

Master address

Enter the address of the master server using the hostname (or IP address) and port, separated by a colon.

Example: MyMaster:5020

Server public address

Enter the public address of the replica server using the hostname (or IP address) and port, separated by a colon. The only use for this setting is to enable the master server to connect to the replica server while performing a Request ownership from replica operation.

Example: MyReplica:5021

Update server automatically

Select this option to enable the replica server to automatically exchange updates at the specified interval.

Note: The COS server's workload may cause the time between two consecutive replication events to exceed the specified interval value.

Replica Properties

Server is Read-Only

Select this option to set the replication functionality as follows:

  • The replica server receives updates from the master server, meaning changes made in the master server are replicated to the replica server.

  • The replica server does not send updates to the master server, thus changes made in the replica server are not replicated to the master server.

  • The replica server can only modify objects that it owns. It is unable to check out, check in, request ownership, or relinquish ownership of objects owned by the master server.

These rules apply not only to COS objects but also to associated files, such as documents.

Note: On the master server, this option can be enabled or disabled from the Properties of the replica server.

Enable replica running newer SW version from root

(This option is not available.)

Update With Master

Update

On a replica server that is online, this command exchanges new and changed data with the master server.

On a replica server that is offline, this command opens a file browser for saving new and changed data to an Update_from_<replica>.upd file on the disk. This update file should then be sent to the master server and opened there with the From Replica command.

Rebuild

On a replica server that is online, this command sends all the data from the replica server to the master server. The master server then compares its existing data with the data received from the replica, selecting the most recent version of each object to update the master data.

On a replica server that is offline, this command opens a file browser for saving all the data to an Update_from_<replica>.upd file on the disk. This update file should then be sent to the master server and opened there with the From Replica command.

Note: Rebuilding the database may take a considerable amount of time, and during this period, all other operations may be slower on both the master and the replica.

Receive Offline Update File

From Master

On a replica server that is offline, this command opens a file browser for selecting the Update_to_<replica>.upd file sent from the master server.

From Replica

On a master server, this command opens a file browser for selecting the Update_from_<replica>.upd file sent from an offline replica, reads the data from the file, and opens a file browser for saving an Update_to_<replica>.upd file. This update file should then be sent to the replica server and opened there with the From Master command, to complete the update cycle.

Replica Servers

On a master server, lists the replica servers of the master server.

Replication mode for replicas

Select whether to enforce a specific replication mode for all replica servers.

Remove

Removes the selected replica server.

Add

Allows creating a new replica server for the selected server, as described in Creating replica server installation (.cri) files.

Properties

Opens the Replica Properties dialog which shows information about the selected replica server.

General

Force replica to be read-only

Select this option to try to force the replica server into read-only mode. This requires that the replica server is using online replication. If the replica server is using offline replication and there is an attempt to update the master server with an update file received from the replica server, an error message indicates that the update cannot be performed.

Multi server control

On the Server List tab, select two or more COS servers to display the following settings.

Control

Description

Replicate chain

Use these commands to initiate replication of data on the selected COS servers.

Bottom Up

This command initiates the replication process on the selected servers, starting from the bottom-most server and moving upward in the server hierarchy.

Top Down

This command initiates the replication process on the selected servers, starting from the top-most server and moving downward in the server hierarchy.

Replication Settings

Use these commands to set the selected COS servers online or offline. For more information, see Replication.

Set online

This command sets the selected servers online, enabling them to replicate data via an online connection.

Set offline

This command sets the selected servers offline. Replication must be performed using manual file transfer.

Backup Settings

Use these settings to specify where and when to back up the data of the selected COS servers.

Target

Specify where to store the backup files.

Backup path

Specify the path to the folder where the backup files will be created.

The path can point to either a local folder on the server computer or a remote folder located on a different computer. To use a remote folder, define the path as a UNC path.

The backup process creates temporary files on the local disk and removes them when they are no longer needed.

The backup files are named in the format <serverName>_<yyymmdd>.bup.

Important: The project's settings can specify that a COS backup must include an SQL backup, as described in SQL backup. To do this, the SQL server must have access to the target directory. However, it does not support UNC paths. Therefore, a COS backup that includes an SQL backup can only succeed if both COS and SQL are installed on the same computer, and the target directory is a local folder on that computer. If the backup path specifies a remote folder with a UNC path, the operation will fail when attempting to back up the SQL data. If COS backups require a remote folder, SQL backups must be created separately on the local disk, as described in Create SQL Backup.

Account

Specify the user account the backup process will use for writing to the target folder.

The server's user account

Select this option to use the COS server's user account for creating the backups. This is the user account that you used to Connect to the server.

Note: If the backup path points to a remote folder, this must be a domain account that has the required privileges on the target computer.

Another account

Select this option to use a specified user account for backups, for example, when the backup files are saved to a remote computer.

Note: If the backup path points to a remote folder, this must be a domain account that has the required privileges on the target computer.

Scheduled backup

Specify a schedule for automatic backups.

Start backup daily

Select this option to back up the data of the selected COS servers every day.

Enter the start time in the format hh:mm.

Schedule backups with intervals of

Select this option to perform the backups so that each additional backup starts a specified number of minutes after the previous one.

Enter the interval in minutes.

Delete backups older than

Select this option to automatically delete the daily backup after a specified number of days.

Note: If you want to create a server backup immediately, select a single server and navigate to the Backup tab.